home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / race150.zip / RACE.DOC < prev    next >
Text File  |  1991-11-02  |  97KB  |  2,598 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                               RACE Version 1.30 
  29.  
  30.                          REMOTEACCESS CALLER EDITOR 
  31.          Copyright 1989,1991 Michael F. Janke. All rights reserved.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                             TABLE OF CONTENTS
  43.  
  44.  
  45.         SECTION                 TITLE                           PAGE
  46.  
  47.         1                  CHAPTER 1 -- INTRODUCTION   ........... 1
  48.         1.1                     Features   ....................... 1
  49.         1.2                     Requirements   ................... 2
  50.         1.3                     Acknowledgements   ............... 2
  51.         1.4                     Special Characters   ............. 3
  52.  
  53.         2                  CHAPTER 2 -- LICENSING   .............. 4
  54.         2.1                     ShareWare Notice   ............... 4
  55.         2.2                     License Fee   .................... 4
  56.         2.3                     License Agreement   .............. 4
  57.         2.4                     Disclaimer   ..................... 5
  58.         2.5                     How to register   ................ 5
  59.  
  60.         3                  CHAPTER 3 -- CONFIGURATION   .......... 6
  61.         3                       General Information   ............ 6
  62.         3.1                     120to130.EXE   ................... 7
  63.         3.2                     RACECFG.EXE   .................... 8
  64.         3.2                     FILES   .......................... 8
  65.         3.2(1)                  SYSTEM FILENAMES   ............... 8
  66.         3.2(1a)                 Users.bbs   ...................... 8
  67.         3.2(1b)                 AnswerFile   ..................... 8
  68.         3.2(1c)                 StorageFile   .................... 8
  69.         3.2(1d)                 SwapFile   ....................... 8
  70.         3.2(2)                  EXTERNAL UTILITIES   ............. 9
  71.         3.2(3)                  DOS SHELL   ...................... 9
  72.         3.2(4)                  EXIT SETUP   ..................... 9
  73.         3.3                     VALIDATION   .................... 10
  74.         3.3(1)                  Validation Templates   .......... 10
  75.         3.3(2)                  Welcome Message Setup   ......... 10
  76.         3.4                     COLORS   ........................ 12
  77.         3.5                     MISCELLANEOUS   ................. 12
  78.         3.5(a)                  Insert Mode   ................... 12
  79.         3.5(b)                  Beep   .......................... 12
  80.         3.5(c)                  Edit Delimiters   ............... 12
  81.         3.5(d)                  Auto-Store Answers   ............ 12
  82.         3.5(e)                  Auto-Search Answers   ........... 12
  83.         3.5(f)                  Name field in reports   ......... 13
  84.         3.5(g)                  Hidden Passwords   .............. 13
  85.         3.6                     Template Flag Configuration   ... 14
  86.         3.7                     User Flag Notes   ............... 15
  87.  
  88.  
  89.  
  90.  
  91.  
  92.                                    I 
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.                         TABLE OF CONTENTS (CONTINUED)
  102.  
  103.  
  104.         SECTION                 TITLE                           PAGE
  105.  
  106.         4                  CHAPTER 4 -- GENERAL INFORMATION   ... 16
  107.         4.1                     Help system   ................... 16
  108.         4.2                     Remote Operation   .............. 16
  109.         4.3                     Main Screen   ................... 17
  110.  
  111.         5                  CHAPTER 5 -- EDITING USERS   ......... 18
  112.         5.1                     Editing Restrictions   .......... 18
  113.         5.2                     Editing Individual Fields   ..... 19
  114.         5.3                     Changes without editing   ....... 19
  115.         5.4                     Moving through user file   ...... 20
  116.         5.4(1)                  Goto command   .................. 20
  117.         5.4(1)                  Viewing users via User list   ... 20
  118.  
  119.         6                  CHAPTER 6 -- VALIDATION ROUTINES   ... 21
  120.         6.1                     General information   ........... 21
  121.         6.2                     Questionnaire Setup   ........... 22
  122.         6.3                     POSTINFO   ...................... 22
  123.         6.4                     Comment Import   ................ 23
  124.         6.5                     Templates   ..................... 24
  125.         6.6                     Welcome message   ............... 25
  126.         6.7                     Validate menu options   ......... 26
  127.  
  128.         7                  CHAPTER 7 -- REPORTS   ............... 28
  129.         7.1                     User reports menu   ............. 28
  130.         7.2                     Report options   ................ 29
  131.         7.3                     Field selection   ............... 30
  132.         7.4                     Report searching   .............. 30
  133.  
  134.         8                  CHAPTER 8 -- SEARCH   ................ 31
  135.         8.1                     The search menu   ............... 31
  136.         8.2                     Search operation   .............. 31
  137.         8.4                     Search Name/Alias   ............. 32
  138.         8.5                     Search City/phone/Pwd   ......... 32
  139.         8.6                     Search Security/group   ......... 32
  140.         8.7                     Search Uploads/downloads   ...... 33
  141.         8.8                     Search Flags   .................. 33
  142.  
  143.         9                  CHAPTER 9 -- GLOBAL CHANGES   ........ 34
  144.         9.1                     General information   ........... 34
  145.         9.2                     Attribute flags   ............... 34
  146.         9.3                     Security flags   ................ 35
  147.         9.4                     Group changes   ................. 35
  148.         9.5                     Using Group/Sec levels   ........ 35
  149.         9.6                     Executing changes   ............. 36
  150.  
  151.                                   II 
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.                         TABLE OF CONTENTS (CONTINUED)
  161.  
  162.  
  163.         SECTION                 TITLE                           PAGE
  164.  
  165.  
  166.         10                 CHAPTER 10 -- ADD NEW USER   ......... 37
  167.  
  168.         11                 CHAPTER 11 -- JUMP/UTILS   ........... 38
  169.         11.1                    General information   ........... 38
  170.         11.2                    Jump to dos   ................... 38
  171.         11.3                    Utilities   ..................... 39
  172.  
  173.         12                 CHAPTER 12 -- PACK/SORT   ............ 39
  174.         12.1                    General information   ........... 40
  175.         12.2                    Pack/Sort menu   ................ 40
  176.         12.3                    Packing   ....................... 41
  177.         12.3(a)                 Start packing   ................. 41
  178.         12.3(b)                 Age parameter   ................. 41
  179.         12.3(c)                 Security parameter   ............ 41
  180.         12.3(d)                 Honor No-Kill   ................. 42
  181.         12.4                    Sorting   ....................... 42
  182.         12.5                    Whoops!  - Restore users   ...... 43
  183.         12.5(a)                 Restoring users   ............... 44
  184.         12.5(b)                 Deleting Users.old   ............ 44
  185.  
  186.                    APPENDIX A -- PROBLEMS?    ........... 45 
  187.  
  188.                    APPENDIX B -- EDITING KEYS   ......... 48 
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.                                   III 
  210.  
  211.  
  212.       INTRODUCTION                  RACE                         Page 1 
  213.  
  214.  
  215.  
  216.  
  217.         
  218.  
  219.  
  220.                                   CHAPTER 1 
  221.  
  222.                                 Introduction 
  223.  
  224.  
  225.  
  226.       RACE is a multi-function user editor for the RemoteAccess Bulletin 
  227.       Board System.  Besides its obvious duties  as  an  editor  for  an
  228.       individual caller's data, it has many addition features.  
  229.  
  230.  
  231.  
  232.       1.1  Features 
  233.  
  234.  
  235.          * Searches on specific user fields including flags.  
  236.  
  237.          * Globally change security flags.  
  238.  
  239.          * Globally change attributes.  
  240.  
  241.          * Custom reports.  
  242.  
  243.          * Swapping to EMS or disk during shells.  
  244.  
  245.          * New user validation routines.  
  246.  
  247.          * Send user a prepared message when validating.  
  248.  
  249.          * Attach reminder notes to user security flags.  
  250.  
  251.          * Pack user file.  
  252.  
  253.          * Sort user file.  
  254.  
  255.          * WHOOPS!  function to restore users PACKed out.  
  256.  
  257.          * Much, much more!  
  258.  
  259.       
  260.  
  261.  
  262.       INTRODUCTION                  RACE                         Page 2 
  263.  
  264.  
  265.  
  266.  
  267.       1.2  Requirements 
  268.  
  269.       Ms-Dos 3.x (or its equivalent) is required for proper operation.  
  270.  
  271.       180k of free ram is recommended.  Less  is  possible  though  some
  272.       items  will  be  disabled.   sorting and packing will require more
  273.       depending on the size of your user base.  
  274.  
  275.  
  276.  
  277.  
  278.       1.3  Acknowledgements/Credits 
  279.  
  280.       Special thanks go out to the beta testers that helped to test RACE 
  281.       and offered many feature requests.  They are: Bruce  Bodger,  Fred
  282.       Horner, Ed Meloan, Peter Janssens and the rest of the RemoteAccess 
  283.       beta test team.  Thanks guys!
  284.  
  285.       A special thanks to James Berry for his persistance during some
  286.       difficulties with EGA/VGA mode changes and for providing some
  287.       much needed code for this portion of RACE.
  288.  
  289.       Thanks to Joaquim Homrighausen, author of  the  popular  FrontDoor
  290.       mailer  system,  for  unselfishly  allowing  me to create the RACE
  291.       configuration program in the image of the FrontDoor Setup program.  
  292.  
  293.       Thanks also go to Andrew Milner and Phil Mackay  for  providing  a
  294.       great piece of bulletin board software.  
  295.  
  296.       And last but not least, thanks to TurboPower Software,  Inc.   for
  297.       their EXECSWAP code which provides the swapping routines in RACE.  
  298.  
  299.  
  300.       * RemoteAccess (C) 1990 Andrew Milner & Continental Software.  
  301.  
  302.       * FrontDoor (C) Copyright Joaquim H.  Homrighausen, 1986-1991.
  303.  
  304.       
  305.  
  306.  
  307.       INTRODUCTION                  RACE                         Page 3 
  308.  
  309.  
  310.  
  311.  
  312.       1.4  Special characters used in this manual 
  313.  
  314.  
  315.       <> 
  316.  
  317.       The  <>  character combination is used to surround characters that
  318.       you are required to press to activate a  particular  command.   In
  319.       the  case  of  the CTRL or ALT key, <Ctrl-P> would mean you are to
  320.       press the CTRL key and hold it, then press the letter "P" on  your
  321.       keyboard.   <Alt-D> would be similar, except of course the ALT key
  322.       is pressed in this case.  
  323.  
  324.       If  this  document  shows a command such as <V>alidate, that means
  325.       you would press the letter "V" on your keyboard  to  activate  the
  326.       validate command.  
  327.  
  328.  
  329.       "" or '' 
  330.  
  331.       Double  and  single  quotes  are  used for emphasis and to clarify
  332.       input that is expected from the user.  One would not actually type 
  333.       the quote characters unless specifically instructed to do so.  
  334.  
  335.  
  336.  
  337.       
  338.  
  339.  
  340.       INTRODUCTION                  RACE                         Page 4 
  341.  
  342.  
  343.  
  344.  
  345.         
  346.  
  347.  
  348.                                   CHAPTER 2 
  349.  
  350.                                   Licensing 
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.       2.1  Shareware notice 
  358.  
  359.       Prior  to  version  1.30,  RACE  was  freeware.   There  were  few
  360.       restrictions and a user of RACE was not required  to  register  in
  361.       any way, shape or form.  
  362.  
  363.       This has changed as of the release of RACE version 1.30.  RACE  is
  364.       now  shareware.   If  after  21 days you find that RACE suits your
  365.       needs and you wish to continue using it, you  must  register  RACE
  366.       and pay the license fee.  
  367.  
  368.  
  369.  
  370.       2.2  License fee 
  371.  
  372.       The  fee  for  RACE  is  $10.00  in United States funds.  This fee
  373.       applies to both private and commercial single site  installations.
  374.       Information  on  licensing  multiple  copies  may  be  obtained by
  375.       contacting the author at the address listed in section  2.5,  "How
  376.       to register RACE".  
  377.  
  378.  
  379.  
  380.       2.3  License agreement 
  381.  
  382.       In  consideration  of  payment  of  the license fee, I, Michael F.
  383.       Janke (hereinafter referred to  as  "the  author"),  as  licensor,
  384.       grant  to  you,  the  licensee,  a  nonexclusive right to use RACE
  385.       (hereinafter known as "the software") on a single  computer  at  a
  386.       single location.  
  387.       
  388.  
  389.  
  390.       INTRODUCTION                  RACE                         Page 5 
  391.  
  392.  
  393.  
  394.  
  395.       2.4  Disclaimer of warranty and limited warranty 
  396.  
  397.       The software and accompanying  materials  (including  instructions
  398.       for  use)  are  provided  "as  is"  without  warranty of any kind.
  399.       Further, the author does  not  warrant,  guarantee,  or  make  any
  400.       representations  regarding  the use, or the results of the use, of
  401.       the  software  or  written  materials  in  terms  of  correctness,
  402.       accuracy, reliability, currentness or otherwise.  
  403.  
  404.       The  author  shall  not  be  liable  for  any  direct,   indirect,
  405.       consequential,  or  incidental damages (including damages for loss
  406.       of business  profits,  business  interruption,  loss  of  business
  407.       information,  and the like) arising out of the use or inability to
  408.       use the software even if  the  author  has  been  advised  of  the
  409.       possibility of such damages.  
  410.  
  411.  
  412.  
  413.       2.5  How to register RACE 
  414.  
  415.       Why should you  even bother to  register you  ask?  First, it's  a
  416.       legal requirement.  Second, if you want to see RACE continue to be 
  417.       developed  and improved, registration  will encourage me to do so.
  418.       Third, a few  extra features are enabled by registering.  Although
  419.       lack of  these features in  no way prevents full use of RACE, they
  420.       do provide that little extra touch.
  421.  
  422.       Many months of hard work went into producing this  product  and  I
  423.       believe  you  will  find  it  is  worth  the small $10 fee that is
  424.       required.  Your $10 registration will be good for the life of  the
  425.       product  and  no matter what changes occur, you will never have to
  426.       pay another registration fee for RACE.  
  427.  
  428.       To register RACE, $10.00 in U.S.  funds should be sent to: 
  429.  
  430.           Michael F.  Janke 
  431.           8261-B SW 107th Ave.  
  432.           Miami, Florida 33173 
  433.  
  434.       Checks or money orders  should  be  made  payable  to  Michael  F.
  435.       Janke, NOT "RACE Registration".
  436.  
  437.       So that I  may  acknowledge  your  registration,  please  use  the
  438.       REGISTER.FRM  file  that  is  included  in  the  RACE distribution
  439.       archive.  This file also contains information on RACE registration
  440.       sites located in Australia and Europe.
  441.  
  442.       
  443.  
  444.  
  445.       CONFIGURING RACE V1.30        RACE                         Page 6
  446.  
  447.  
  448.  
  449.  
  450.         
  451.  
  452.  
  453.                                   CHAPTER 3 
  454.  
  455.                       Configuration general information 
  456.  
  457.  
  458.  
  459.       RACE uses an external configuration file for information  such  as
  460.       paths  to various files, colors, etc.  This file is not ASCII text
  461.       and it can only be edited with RACECFG.EXE.  
  462.  
  463.       The configuration file name, RACE.CFG, must not be changed.  Doing 
  464.       so will cause RACE to abort when it cannot find RACE.CFG.  
  465.  
  466.       RACE does a pretty good job of  tracking  down  its  configuration
  467.       file.   The configuration file will be found as long as it resides
  468.       in any of the following directories.  
  469.  
  470.       * The current directory 
  471.  
  472.       * The directory where RACE.EXE resides 
  473.  
  474.       * In one of the directories defined in your PATH 
  475.  
  476.       RACECFG is always in edit mode for the  field  you  are  currently
  477.       'in'.   That  is,  as you use your cursor keys to move through the
  478.       fields you will notice that field is highlighted in reverse  video
  479.       as  you  move  to it.  A highlighted field is the active field and
  480.       you may use any of the available edit keys to edit the field.  See 
  481.       Appendix B for a complete list of editing keys that may be used in 
  482.       the fields.  
  483.  
  484.       Once you move out of a field, any changes made to that  field  are
  485.       saved  within  RACECFG.  If you edit a field, then hit <enter> and
  486.       the cursor moves to another field, <Esc> may be  pressed  at  that
  487.       point and the change made is not lost.  
  488.  
  489.       RACECFG knows if changes were made and when  you  select  to  exit
  490.       RACECFG,  either  by  going into the main menu FILES submenu or by
  491.       pressing <ESC> at the main menu, RACECFG will  ask  "Save  changes
  492.       (Y,N)" if any changes were made.  
  493.  
  494.       
  495.  
  496.  
  497.       CONFIGURING RACE V1.30        RACE                         Page 7
  498.  
  499.  
  500.  
  501.  
  502.       3.1  120to130.EXE - Conversion program 
  503.  
  504.       If you're a user  of  RACE  v1.20,  this  program  will  ease  the
  505.       transition  to  RACE  v1.30.   A  few items have been added to the
  506.       RACE.CFG file and your current v1.20 RACE.CFG  is  not  usable  by
  507.       RACE v1.30.  
  508.  
  509.       120to130.exe will read your current v1.20 configuration  file  and
  510.       write  the  new v1.30 configuration file using all of your current
  511.       settings.  Default values are set for the new  items.   This  will
  512.       reduce the time you will have to spend configuring RACE v1.30.  
  513.  
  514.       Run 120to130.exe in the directory that contains your current v1.20 
  515.       configuration  file.   Make sure you are not attempting to convert
  516.       the default RACE.CFG that comes in the v1.30 distribution archive. 
  517.       While no harm would be done in this case, it would be pointless to 
  518.       perform the conversion on the new configuration file.  
  519.  
  520.       120to130.exe will read your current configuration  file,  renaming
  521.       it  to RACECFG.OLD and will write out the new file, properly named
  522.       RACE.CFG.  Once this is done you are ready to run  RACECFG.EXE  to
  523.       set  up  the new items to your preference.  The items that are new
  524.       or  changed  and  need  to  be  set  are  in  the  VALIDATION  and
  525.       MISCELLANEOUS selection on the RACECFG main menu.  These new items 
  526.       are: 
  527.  
  528.            1.  VALIDATION  CONFIGURATION  - Two new fields have been add
  529.                to each template: Subscription expiration time and  group
  530.                number.  
  531.  
  532.            2.  NAME FIELD SIZE - This defines how large the  name  field
  533.                should be when included in reports.  
  534.  
  535.            3.  HIDE PASSWORDS IN VIEW MODE - This defines  the  viewable
  536.                status of all user passwords in the main RACE screen.  
  537.  
  538.       These new items  are  explained  in  detail  farther  on  in  this
  539.       chapter.  
  540.       
  541.  
  542.  
  543.       CONFIGURING RACE V1.30        RACE                         Page 8
  544.  
  545.  
  546.  
  547.  
  548.                        RACECFG.EXE - Main Menu options 
  549.  
  550.  
  551.  
  552.       3.2  FILES 
  553.  
  554.       Select  this  item  in  the  RACECfg menu and a pulldown menu will
  555.       appear.  Within this menu are  two  configuration  items  and  two
  556.       items  not  related  to  configuring  RACE.  The first item in the
  557.       menu, "System Filenames", is the most important.  Before  you  can
  558.       even  give  RACE  a  trial run you will have to define the path to
  559.       your user file.  Select "System Filenames" and the following  four
  560.       path\filenames may be defined.  
  561.  
  562.  
  563.  
  564.  
  565.       (1)  SYSTEM FILENAMES
  566.  
  567.  
  568.            a.  USERS.BBS  - This is a fully defined path AND filename of
  569.                your user file.  Don't forget the filename  because  RACE
  570.                does not assume USERS.BBS.  
  571.  
  572.            b.  ANSWERFILE - The fully defined path and filename  of  the
  573.                questionnaire  answer  file  that will be acted upon when
  574.                you use the RACE <V>alidate function.  The filename  will
  575.                most likely be NEWUSER.ASW, but you can validate based on 
  576.                the answers to any questionnaire you so desire.  
  577.  
  578.            c.  STORAGEFILE  -  The fully defined path and filename of an
  579.                ascii text file that can be used for storing the  answers
  580.                of  users  you  have validated.  This is an optional item
  581.                but  is  required  if  you  wish  to   use   the   <S>ave
  582.                sub-function  within <V>alidate or if AUTOSTORE is ON for
  583.                the validation function.  
  584.  
  585.            d.  SWAP FILE - A fully defined path AND filename for RACE to
  586.                use when swapping itself out of ram  and  to  disk.   The
  587.                path can point to a ram disk.  
  588.  
  589.  
  590.                If RACE finds EMS available, it will attempt to use  that
  591.                for  the  swap image instead of the disk file.  Note that
  592.                even though you may have EMS available for  RACE  to  use
  593.                for  the swap image, a path must be defined.  Leaving the
  594.                path definition blank signals RACE that you do  not  wish
  595.                RACE to swap in any way.  
  596.       
  597.  
  598.  
  599.       CONFIGURING RACE V1.30        RACE                         Page 9
  600.  
  601.  
  602.  
  603.  
  604.       (2)  EXTERNAL UTILITIES
  605.  
  606.  
  607.       The  second  item  in  the  FILES  pulldown  menu   is   "External
  608.       Utilities".   These  are programs you would like to be able to run
  609.       from within RACE and they are optional.  It is  not  necessary  to
  610.       define any external utilities here if you have no use for them.  
  611.  
  612.       If you do wish to define utilities in this section, you need  only
  613.       define the program exactly as you would run it from DOS.  That is, 
  614.       a full path name is not necessary if  the  utility  resides  in  a
  615.       directory that is defined in your Dos PATH.  
  616.  
  617.  
  618.  
  619.  
  620.       (3)  DOS SHELL
  621.  
  622.  
  623.       The third item in the main menu  FILES  selection  is  DOS  shell.
  624.       This,  as  the  name  implies,  will allow you to jump to DOS from
  625.       within RACECFG.  
  626.  
  627.  
  628.  
  629.  
  630.       (4)  EXIT SETUP
  631.  
  632.  
  633.       This can be used to exit RACECFG once  you  are  done  configuring
  634.       RACE.   It  is not necessary to go to this option to exit RACECFG.
  635.       Simply press your <ESC> key.  RACECFG knows  if  you've  made  any
  636.       changes  and either exit method will ask "Save Changes?  (Y,N)" if
  637.       you have made changes to the configuration.  There is  no  default
  638.       key for this question.  You must press the "Y" or "N" key.  
  639.  
  640.       
  641.  
  642.  
  643.       CONFIGURING RACE V1.30        RACE                         Page 10
  644.  
  645.  
  646.  
  647.  
  648.       3.3  VALIDATION  -  Template and Welcome msg setup.
  649.  
  650.  
  651.       (1) TEMPLATES
  652.  
  653.            a.  Template  Label  - This allows you to give meaningful (to
  654.                you) labels to the  5  possible  upgrade  levels.   These
  655.                labels will appear in the RACE validation menu.  
  656.  
  657.            b.  Template Access - The security level that will  be  given
  658.                to a user when upgrading with the selected template.  
  659.  
  660.            c.  Flags - There are three types of flags that are definable
  661.                in  the template setup screen.  They are: Security flags,
  662.                NO-KILL attribute flag and XFER PRIORITY attribute  flag.
  663.                Security  flag  setup  requires quite a bit of explaining
  664.                and this is done in detail at the  end  of  this  chapter
  665.                under  the  title "Template security flag configuration".
  666.                The NO-KILL and XFER PRIORITY template settings can  only
  667.                turn  ON those attributes when upgrading a user.  Setting
  668.                them to 'N' will NOT toggle those attributes OFF.  
  669.  
  670.            d.  Subscription  -  If  you  run a subscription system, RACE
  671.                will  help  you  to  take  full  advantage  of  the   new
  672.                subscription features built into RemoteAccess 1.00.  This 
  673.                particular field is meant to hold a  number  representing
  674.                the number of months you are giving a user when upgrading 
  675.                with this template number.   You  may  define  up  to  99
  676.                months  in this field.  Enter zero (0) if you do not want
  677.                RACE to automatically fill in the subscription expiration 
  678.                date  in  the  user  record  when  you  upgrade  via  the
  679.                <V>alidate option.  
  680.  
  681.            e.  Group - If you want to automatically assign the user to a
  682.                specific group number when  upgrading  with  a  template,
  683.                supply  the  group number here.  Entering -1 as the group
  684.                number tells RACE not to  touch  the  user  group  number
  685.                during an upgrade.  
  686.       
  687.  
  688.  
  689.       CONFIGURING RACE V1.30        RACE                         Page 11
  690.  
  691.  
  692.  
  693.  
  694.       (2) WELCOME MSG
  695.  
  696.            a.  SEND WELCOME MESSAGE?  -  If  you're  not  interested  in
  697.                having  RACE  post  a  prepared  message when upgrading a
  698.                user, set this to 'N'.  
  699.  
  700.            b.  PATH\FILENAME - This is the full path and FILENAME of the
  701.                prepared messages that will  be  used  when  upgrading  a
  702.                user.   DO  NOT  supply  an  extension with the filename.
  703.                RACE automatically appends .00# where '#' is  the  number
  704.                of the template you use to upgrade a user.  
  705.  
  706.  
  707.  
  708.                Chapter  6,  Section  6.6  provides   a   more   complete
  709.                explanation  of  the filenaming convention used for these
  710.                files.  
  711.  
  712.  
  713.  
  714.            c.  FROM - This would normally be your name but it could also
  715.                be 'Sysop' or any name you desire.  
  716.  
  717.            d.  SUBJECT - What you want RACE to use as the subject of the
  718.                message.  
  719.  
  720.            e.  BOARD NUMBER - This is the board number to which you want
  721.                the welcome message posted.  This can be any board number 
  722.                from 1 to 200.  It is up to you to insure  the  user  has
  723.                access to this board number.  
  724.  
  725.            f.  PRIVATE?  - Do you want  the  welcome  message  to  be  a
  726.                private message?  
  727.       
  728.  
  729.  
  730.       CONFIGURING RACE V1.30        RACE                         Page 12
  731.  
  732.  
  733.  
  734.  
  735.       3.4  COLORS 
  736.  
  737.       This  will  allow  you to configure the colors that RACE will use.
  738.       You may also turn Snow checking ON in this section.  
  739.  
  740.       You will be able to customize the colors  or  select  the  default
  741.       colors  that  were  supplied  with  the  distribution  package.  A
  742.       representative sample of the window being configured  is  show  on
  743.       the  screen  so  you can see what the colors will look like as you
  744.       select new colors.  
  745.  
  746.  
  747.  
  748.  
  749.       3.5  MISCELLANEOUS 
  750.  
  751.  
  752.            a.  START  EDITOR  IN INSERT MODE - The default configuration
  753.                for this item is NO, that is, the editing mode for a user 
  754.                record is initially set to overtype.  This may be toggled 
  755.                within the editor while editing by pressing  your  INSert
  756.                key.  
  757.  
  758.            b.  BEEP ON ERROR - RACE normally beeps at you if you attempt
  759.                to  enter  invalid data into a user field.  For instance,
  760.                trying to enter alphabetical characters into the security 
  761.                field would generate a beep.  If you find beeps annoying, 
  762.                set this item to NO.  
  763.  
  764.            c.  EDIT  MODE LEFT/RIGHT DELIMITERS - RACE defaults to using
  765.                no  delimiter  characters   for   edit   fields.    These
  766.                characters  show  the  boundaries  of the particular user
  767.                field you are editing.  If you  want  delimiters,  select
  768.                these  items  and enter the character of your choice.  If
  769.                you want no  delimiters  the  left  and  right  delimiter
  770.                character must be set to zero, that is, the number 0.  
  771.  
  772.            d.  AUTO-STORE ANSWERS - If you have defined a  storage  file
  773.                for upgraded user answers, this option will cause RACE to 
  774.                automatically copy the user answers to this file as  soon
  775.                as the user is upgraded with one of the templates.  
  776.  
  777.            e.  AUTO-SEARCH  ANSWERS  -  If  set  to   'Y',   RACE   will
  778.                automatically  search  the  questionnaire answer file for
  779.                the user that is currently  on-screen  when  you  pressed
  780.                <V>alidate.   If  this option is set to 'N' you will have
  781.                to manually search for the  answers  by  pressing  <F>ind
  782.                answ in the RACE validation menu.  
  783.  
  784.  
  785.       
  786.  
  787.  
  788.       CONFIGURING RACE V1.30        RACE                         Page 13
  789.  
  790.  
  791.  
  792.  
  793.            f.  NAME  FIELD  SIZE IN REPORTS - RACE has the capability of
  794.                generating reports  of  various  types.   One  item  that
  795.                limits  the  usefulness  of  these reports is the default
  796.                size of the user name field.  If RACE always  assumed  it
  797.                should  output the full name field, 35 characters, almost
  798.                half of the report line would be consumed by this  field,
  799.                much of it blank.  
  800.  
  801.  
  802.                It is quite likely that you will never have a  user  that
  803.                has  a  name  that is anywhere near the length this field
  804.                allows.  The "Name field size in reports"  option  allows
  805.                you to define how much of the name field you want RACE to 
  806.                use for report purposes ONLY.  This does NOT modify  your
  807.                users.bbs  in  any  way.   The  acceptable range for this
  808.                setting is 1 to 35.  
  809.  
  810.  
  811.                A useful setting would be 15 or 20.  Since  RACE  outputs
  812.                user  names  in a Lastname,Firstname fashion for reports,
  813.                it is likely that if any part of the name  is  truncated,
  814.                it will be the first name, not the last.  
  815.  
  816.  
  817.  
  818.            g.  HIDE PASSWORD IN VIEW MODE - RACE provides a  very  small
  819.                measure  of  security with user passwords.  Some users of
  820.                RACE have expressed a desire  for  the  ability  to  hide
  821.                passwords  because of the fact that when RACE is started,
  822.                the  Sysop  record  is  immediately  displayed,  password
  823.                included.   This could be a problem if someone is looking
  824.                over your shoulder.  
  825.  
  826.  
  827.                If you set this option to "Y", RACE will not display  the
  828.                password in VIEW mode.  RACE won't place asterisks in the 
  829.                place of the password, the field will just appear  to  be
  830.                blank.   Going  into edit mode and moving to the password
  831.                field will display the password as will any of the custom 
  832.                reports  if  that  field is selected for inclusion in the
  833.                report.  
  834.  
  835.  
  836.                Again, this is a very  minimal  amount  of  security  but
  837.                enough   to   prevent  the  accidental  display  of  your
  838.                password.    Passwords   may   be   temporarily   toggled
  839.                hidden/viewable within RACE by pressing <Alt-F10>.  
  840.  
  841.  
  842.       
  843.  
  844.  
  845.       CONFIGURING RACE V1.30        RACE                         Page 14
  846.  
  847.  
  848.  
  849.  
  850.       3.6  TEMPLATE SECURITY FLAG CONFIGURATION 
  851.  
  852.       The template security flags require a special explanation  because
  853.       they work a bit differently than what most RemoteAccess SysOps are 
  854.       used to.  
  855.  
  856.       Unlike most flag routines, this particular  section  allows  THREE
  857.       settings for flags.  These settings are: 
  858.        
  859.        X  =  Turn this flag ON 
  860.        O  =  Turn this flag OFF 
  861.        -  =  Leave flag as is 
  862.        
  863.       As you probably noticed, the letter 'O' is used to turn a flag off 
  864.       during validation upgrading instead of the usual hyphen  character
  865.       used  elsewhere  in  RACE  and  most  other programs that can edit
  866.       flags.  
  867.  
  868.       For the sake of explaining how this all works,  lets  say  that  a
  869.       first time caller's A flag is initially set by RemoteAccess to: 
  870.        
  871.        XX----X- 
  872.        
  873.       When you upgrade a new user with Template 1, you want to turn flag 
  874.       A2 OFF and turn flag A4 ON, but you want all others to  remain  as
  875.       is.   In  this  case you would set up your template A flag to look
  876.       like this: 
  877.        
  878.        -O-X---- 
  879.        
  880.       Then, when in RACE <V>alidate and using this template to upgrade a 
  881.       user, the user flag would be set to this: 
  882.        
  883.        X--X--X- 
  884.        
  885.       Flags  A1,  A3,  A5, A6, A7 and A8 were left as is because you did
  886.       not specifically set the template to turn them ON or OFF.  Flag A2 
  887.       was  turned  OFF because you specified a 'O' in position A2 during
  888.       Template setup and Flag  A4  was  turned  ON  during  the  upgrade
  889.       because  you specified to do so with the 'X' in position A4 of the
  890.       template setup.  
  891.  
  892.       Try to keep in mind that the hyphen character does NOT turn a flag 
  893.       off and that you should use the letter 'O' for that purpose.  
  894.       
  895.  
  896.  
  897.       CONFIGURING RACE V1.30        RACE                         Page 15
  898.  
  899.  
  900.  
  901.  
  902.       3.7  USER FLAG NOTES 
  903.  
  904.       RACE gives you the capability to  have  reminder  notes  displayed
  905.       when  editing  a  users flags or when using the global flag change
  906.       function.  
  907.  
  908.       If you use a lot of flags you will soon find that it is  sometimes
  909.       difficult to remember what purpose each flag serves.  If you would 
  910.       like to enable this feature, select FLAGS on the main menu  and  a
  911.       second  menu  will  pull  down.   The first item in this menu will
  912.       either indicate "Flag notes enabled"  or  "Flag  notes  disabled".
  913.       Highlight  this  item  and  hit  <enter>  to toggle to the desired
  914.       setting.  
  915.  
  916.       After enabling flag notes (or disabling for that matter)  you  may
  917.       then  enter  your  notes.  Move the cursor down to one of the FLAG
  918.       NOTES (A Flag, B Flag, etc.)  fields and hit ENTER.  You  will  be
  919.       presented  with  a  second  window in which you can enter up to 48
  920.       characters of text for each of the individual flags.  Repeat  this
  921.       process for every flag you wish to have notated.  
  922.  
  923.       
  924.  
  925.  
  926.       General Information           RACE                         Page 16
  927.  
  928.  
  929.  
  930.  
  931.         
  932.  
  933.  
  934.                                   CHAPTER 4 
  935.  
  936.                                     RACE 
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.       4.1  The RACE Help system 
  944.  
  945.       RACE  has  a general help system and in a few instances, a context
  946.       sensitive help system.  Context sensitive help means that you  may
  947.       request  help  for  the  specific  field  or set of fields you are
  948.       presently using.  Help is accessed by pressing <F1>.  
  949.  
  950.       The main menu <K>eys command is also part of the help  system  and
  951.       will  give you a quick refresher on what other keys may be used at
  952.       the main menu and the function they perform.  
  953.  
  954.       You may note that in some of the help screens one or more  of  the
  955.       words appear in a reverse video or a different colored background. 
  956.       Pressing <enter> will take you to the portion  of  the  help  file
  957.       that  describes  the  highlighted  word.  If there are two or more
  958.       words highlighted, use the  arrow  keys  to  move  the  emphasized
  959.       colored  box  to  select that item before pressing enter.  To step
  960.       back to the original help screen, use <ALT-F1>.  
  961.  
  962.  
  963.  
  964.       4.2  Remote Operation 
  965.  
  966.       RACE is not designed to be used from a remote  location  over  the
  967.       modem and this option is not in any future plans.  
  968.  
  969.       A number of SysOps use RACE remotely  by  way  of  DoorWay.   Fred
  970.       Horner,  a  RACE beta tester, is using RACE from a remote location
  971.       using this method.  Fred has supplied the information necessary to 
  972.       set up DoorWay so that you may take advantage of remote operations 
  973.       too.  Please see the DORWYHLP.ZIP archive that was included in the 
  974.       RACE distribution archive for full information.  
  975.       
  976.  
  977.  
  978.       General Information           RACE                         Page 17
  979.  
  980.  
  981.  
  982.  
  983.       4.3  The RACE Main Screen 
  984.  
  985.       RACE begins by displaying the user in  record  position  zero  and
  986.       starts out in what shall be referred to as VIEW MODE.  
  987.  
  988.       Unlike the USERED.EXE program that is supplied with  RemoteAccess,
  989.       RACE  is  not  automatically in edit mode whenever the entire user
  990.       record is on-screen.  
  991.  
  992.       RACE is written to be usable in multi-line systems.  When the user 
  993.       you  are  currently  viewing  is logged on to your BBS, editing of
  994.       that user record is disabled.  In addition, while viewing the user 
  995.       that is online, the RACE title on the main screen changes to: 
  996.  
  997.       "This user ONLINE, editing disabled" 
  998.  
  999.       Editing an online user would do no good since RA rewrites the user 
  1000.       record  at  log  off,  effectively overwriting any changes you may
  1001.       have made during the edit session.  
  1002.  
  1003.       In addition, packing and sorting of the user base is disabled when 
  1004.       ANY  user is online.  Performing either of these actions at such a
  1005.       time could cause catastrophic results such as  a  totally  trashed
  1006.       users.bbs.  
  1007.       
  1008.  
  1009.  
  1010.       Editing a User Record         RACE                         Page 18
  1011.  
  1012.  
  1013.  
  1014.  
  1015.         
  1016.  
  1017.  
  1018.                                   CHAPTER 5 
  1019.  
  1020.                                     Race 
  1021.  
  1022.  
  1023.  
  1024.       Editing a user's record is the  basic  purpose  of  RACE.   Simply
  1025.       press  the 'E' key to change from view mode to edit mode.  If this
  1026.       is your first edit session since starting RACE, you will be placed 
  1027.       in the first field of the currently displayed user record.  
  1028.  
  1029.       If you leave the edit screen in a field other than the first,  you
  1030.       will  be  placed  into that field on subsequent user record edits.
  1031.       This will ease the chore of editing the same field in a number  of
  1032.       user records.  
  1033.  
  1034.       As you enter edit mode the main menu  changes  to  an  edit  menu.
  1035.       This  shows  you the keys used to move around the screen, save the
  1036.       changes or abort changes.  
  1037.  
  1038.  
  1039.  
  1040.       5.1  Editing Restrictions 
  1041.  
  1042.       There are various restrictions in edit  mode  depending  on  which
  1043.       field  you  are  editing.   The  name,  alias, location, password,
  1044.       comment and phone fields will accept any  type  of  data  you  can
  1045.       enter from the keyboard.  
  1046.  
  1047.       All other fields have some type of restriction and RACE  will  not
  1048.       allow  you  to  enter  invalid  data.   Listed  below are the data
  1049.       limitations allowed in those fields.  Numeric  fields  not  listed
  1050.       here have a range of 0 to 64000.  
  1051.  
  1052.            1.  FLAGS - 'X' or '-' only.  
  1053.  
  1054.            2.  TODAYK and TIME TODAY - 0 to 32000 
  1055.  
  1056.            3.  SCREEN LENGTH - 10 to 66 
  1057.  
  1058.            4.  DATE FIELDS - numeric data in the form MM-DD-YY.  
  1059.  
  1060.            5.  TIME FIELD - numeric data in the form HH:MM.  
  1061.  
  1062.            6.  USER ATTRIBUTES - Y or N.  
  1063.       
  1064.  
  1065.  
  1066.       Editing a User Record         RACE                         Page 19
  1067.  
  1068.  
  1069.  
  1070.  
  1071.       5.2  Editing individual fields 
  1072.  
  1073.       RACE provides a number of editing functions within  an  individual
  1074.       field.  There are too many to mention here, and a complete listing 
  1075.       of edit keys is available in Appendix B of this document or in the 
  1076.       RACE online help system.  
  1077.  
  1078.       Some of the more commonly used edit keys are: 
  1079.  
  1080.            1.  <Ctrl-End>  Delete from cursor to end of field.  
  1081.  
  1082.            2.  <Ctrl-Home>  Delete from cursor to beginning of field.  
  1083.  
  1084.            3.  <Ctrl-Y>  Delete entire field.  
  1085.  
  1086.            4.  <Ctrl-T>  Delete word to right of cursor.  
  1087.  
  1088.            5.  <Ctrl-R>  Restore  previous contents of field.  This only
  1089.                works if you have not yet moved out of the field you  are
  1090.                attempting to restore.  
  1091.  
  1092.  
  1093.  
  1094.       5.3  Editing without entering edit mode 
  1095.  
  1096.       There   are   a   few  functions  that  will  allow  you  to  make
  1097.       modifications to a user record without actually entering into edit 
  1098.       mode.  
  1099.  
  1100.       For example, pressing the ALT key and the first letter of  a  user
  1101.       attribute  (ALT-D for deleted, ALT-C for clear screen, etc.)  will
  1102.       toggle that attribute.  
  1103.  
  1104.       There are three exceptions to the above rule.  <ALT-V> will toggle 
  1105.       AVATAR,  <ALT-I>  will  toggle  the  hidden  attribute and <ALT-S>
  1106.       toggles the  full-Screen  reader.   These  key  combinations  were
  1107.       necessary  due to the duplication of attributes that have the same
  1108.       first letter.  
  1109.  
  1110.       The + and - keys will increment and decrement the  security  level
  1111.       of  the  user  currently  on-screen  by one.  ALT + and ALT - will
  1112.       increment and decrement the security level by  10.   The  ALT  +/-
  1113.       will  most likely NOT work on your numeric keypad, only the +/- on
  1114.       the main keyboard.  
  1115.  
  1116.       <Ctrl-C> will clear the TodayK and Time Today fields of  the  user
  1117.       currently being viewed.  
  1118.       
  1119.  
  1120.  
  1121.       Editing a User Record         RACE                         Page 20
  1122.  
  1123.  
  1124.  
  1125.  
  1126.       5.4  - Moving through the user file 
  1127.  
  1128.       The main menu shows four commands  for  moving  through  the  user
  1129.       file:  <F>irst,  <L>ast,  <N>ext  and  <P>revious.  These commands
  1130.       operate just as their name implies.   <F>irst  takes  you  to  the
  1131.       first user, <L>ast to the last user, etc.  
  1132.  
  1133.       In addition to the listed keys, some of the cursor  movement  keys
  1134.       will  allow  you to move through the user file.  Left/Right arrows
  1135.       are the same as the <P>revious/<N>ext keys.  HOME and END take you 
  1136.       to the first and last user respectively.  
  1137.  
  1138.  
  1139.  
  1140.       (1) GOTO
  1141.  
  1142.       If  you  know  the  record  number  of a user you can use the Goto
  1143.       command to jump directly to that record.  Press "G"  to  bring  up
  1144.       the  Goto window.  This window will list the total number of users
  1145.       on your system and prompt you for the record number to  which  you
  1146.       wish to go.  
  1147.  
  1148.       Instead of pressing <G> at the RACE main menu you may begin typing 
  1149.       the record number of the user record you wish to go to.  RACE will 
  1150.       see the numeric input and immediately open the Goto  window  where
  1151.       you type the remainder of the number.  
  1152.  
  1153.  
  1154.  
  1155.       (2)  Reports => User List
  1156.  
  1157.       Selecting  the main menu <R>eports command and then selecting User
  1158.       list is yet another way to move to a specific user.  This function 
  1159.       is described in detail in chapter 7, section 7.1(d).  
  1160.  
  1161.  
  1162.       
  1163.  
  1164.  
  1165.       Validation                    RACE                         Page 21
  1166.  
  1167.  
  1168.  
  1169.  
  1170.         
  1171.  
  1172.  
  1173.                                   CHAPTER 6 
  1174.  
  1175.                              Validation Routines 
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.       6.1  General Information 
  1183.  
  1184.       RACE  takes  full  advantage  of  RemoteAccess  1.0's subscription
  1185.       system support and will allow you to easily perform the  following
  1186.       tasks with one or two key presses: 
  1187.  
  1188.          * Send a welcome message to the user.  
  1189.  
  1190.          * Update the user security level.  
  1191.  
  1192.          * Update the user group number.  
  1193.  
  1194.          * Toggle any number of security flags on/off.  
  1195.  
  1196.          * Automatically set subscription expiration date.  
  1197.  
  1198.          * Turn on No-Kill and/or File Transfer Priority.  
  1199.  
  1200.          * Import designated answers into user comment field.  
  1201.  
  1202.       In addition, five templates are provided so that you may have five 
  1203.       different sets for the above items.  This is so you may  instantly
  1204.       upgrade a user to regular user, special user, visiting sysop, etc.  
  1205.  
  1206.       There is also a manual edit provided for subscription date,  group
  1207.       number,  security  level  and  flags for those special cases where
  1208.       none of the five templates quite  fit  the  user.   You  may  also
  1209.       toggle   user  attributes  by  pressing  the  <Alt>  key  and  the
  1210.       capitalized letter of the attribute name  shown  in  this  screen.
  1211.       For  example,  "hIdden"  would  require pressing <ALT-I> to toggle
  1212.       that attribute.  
  1213.  
  1214.       Once you have properly set up and understand  how  the  validation
  1215.       routines  work, you will find that they will save you considerable
  1216.       time and effort when it comes to validating new users.  
  1217.  
  1218.       
  1219.  
  1220.  
  1221.       Validation                    RACE                         Page 22
  1222.  
  1223.  
  1224.  
  1225.  
  1226.       Please note that throughout the  remainder  of  this  chapter  the
  1227.       apostrophe  character (') is used to emphasize and clarify various
  1228.       points of interest.  These are not to be used in questionnaires or 
  1229.       input,  they  are  only  for clarity.  In the case of OUTPUTANSWER
  1230.       examples,  the  double  quote  character  (")  *IS*  used  in  the
  1231.       questionnaire language.  
  1232.  
  1233.       RACE offers two different methods of validating users.  Both use a 
  1234.       questionnaire  answer  file, but the way the questionnaire is read
  1235.       depends on the method.  The first method is accessed by  the  main
  1236.       menu  <V>alidate command.  The second method is access by pressing
  1237.       <Ctrl-V>.  
  1238.  
  1239.            1.  Main Menu Validate - This method is used when you want to 
  1240.                validate the user you are currently  viewing.   RACE  can
  1241.                scan the questionnaire answer file for this users answers 
  1242.                and display them if found.  
  1243.  
  1244.            2.  <Ctrl-V>  validation  - This is used to sequentially read
  1245.                the answer  file  and  display  the  individual  sets  of
  1246.                answers  on  a one by one basis.  This method is somewhat
  1247.                easier to use in that it is  not  necessary  for  you  to
  1248.                first  find  the  new  user to upgrade.  This mode can be
  1249.                initiated from dos by running RACE with  a  command  line
  1250.                switch of "/V".  
  1251.  
  1252.  
  1253.  
  1254.       6.2  Questionnaire Set up 
  1255.  
  1256.       In  order  to  use the validation routines in RACE you may have to
  1257.       make a few modifications to your current questionnaire file.  
  1258.  
  1259.  
  1260.  
  1261.       6.3  POSTINFO 
  1262.  
  1263.       "POSTINFO" is a RemoteAccess questionnaire language command.  This 
  1264.       tells  RemoteAccess  to  post  the user's name to the answer file.
  1265.       This *MUST* be the FIRST item posted to the user's answers.  
  1266.  
  1267.       RACE uses this POSTINFO information to find the user's name and to 
  1268.       determine where the user's answers begin and end.  If this item is 
  1269.       not the first item that RemoteAccess posts  to  the  answer  file,
  1270.       RACE  will  not find the user's answers or will find the wrong set
  1271.       of answers.  
  1272.       
  1273.  
  1274.  
  1275.       Validation                    RACE                         Page 23
  1276.  
  1277.  
  1278.  
  1279.  
  1280.       6.4  Comment Import 
  1281.  
  1282.       RACE  has  the  ability  to automatically import comments into the
  1283.       user record comment field.  
  1284.  
  1285.       For instance, if you  would  like  to  have  the  user's  Net/Node
  1286.       address in the comment field of the user record, you could ask the 
  1287.       user this question and signify the  answer  as  a  comment  import
  1288.       answer.  
  1289.  
  1290.       This is done in your questionnaire  by  placing  a  '&:'  anywhere
  1291.       within  the  OUTPUTANSWER  text string.  For example if your tenth
  1292.       question was 'Net/Node?:' you would put something like  this  into
  1293.       your questionnaire file: 
  1294.  
  1295.  
  1296.       OUTPUTANSWER "&:Net/Node: " 10 
  1297.  
  1298.       If, for example, the user answered  that  question  with  '135/4',
  1299.       RemoteAccess would place '&:Net/Node: 135/4' into the answer file.  
  1300.  
  1301.       When you upgrade this user, RACE will scan the answer file and  if
  1302.       '&:'  is  found  in  the  answer  file, everything AFTER those two
  1303.       characters up to the end of the line is imported into  the  user's
  1304.       comment field.  
  1305.  
  1306.       Considering the OUTPUTANSWER example shown above, the user  record
  1307.       comment field would then contain 'Net/Node: 135/4'.  
  1308.  
  1309.       If you don't want to use one of the templates to upgrade the  user
  1310.       but  do want the comments imported into the user record, press 'W'
  1311.       to 'Write Cmts'.  RACE will then import any comment lines into the 
  1312.       user record.  
  1313.  
  1314.       If you don't want to waste space in the  limited  (80  chars  max)
  1315.       comment line you could place the '&:' AFTER the OUTPUTANSWER text. 
  1316.       That is, something like this: 
  1317.  
  1318.  
  1319.       OUTPUTANSWER "Net/Node &:" 10 
  1320.  
  1321.       RACE would import everything after the '&:'  and  therefore  would
  1322.       only  import  the  user's  answer,  not  the  OUTPUTANSWER text of
  1323.       'Net/Node'.  
  1324.  
  1325.       Since the comment field is  only  80  characters  long,  use  care
  1326.       choosing  the  items  to  import.   RACE  will  import  up  to  80
  1327.       characters and if the items  you  have  chosen  will  exceed  that
  1328.       amount, RACE will merely chop off the excess, possibly leaving out 
  1329.       something you consider important.  
  1330.       
  1331.  
  1332.  
  1333.       Validation                    RACE                         Page 24
  1334.  
  1335.  
  1336.  
  1337.  
  1338.       A sample questionnaire file (SAMPLE.Q-A) has been provided in  the
  1339.       distribution  package.   This  sample is only meant to give you an
  1340.       idea of the format of the required and optional items that go into 
  1341.       a  questionnaire  and  though it is fully functional, it is not as
  1342.       complete as most SysOps would like.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.       6.5  Templates 
  1348.  
  1349.       The  templates are the heart of the validation routines.  Pressing
  1350.       the number of the template you wish to apply to a user  will  give
  1351.       the  user  all  the  settings  for that template as defined during
  1352.       configuration.  
  1353.  
  1354.       The automatic turning ON and OFF of user security flags  seems  to
  1355.       have  caused  the  most confusion in the past.  Please re-read the
  1356.       description of this set up in Chapter 3, Section 3.6.  
  1357.  
  1358.       If the particular template you apply has a subscription expiration 
  1359.       associated  with  it,  the  number  of  months you have set during
  1360.       configuration is applied based on your current  system  date.   If
  1361.       your system date is incorrect, the expiration date be incorrect.  
  1362.       
  1363.  
  1364.  
  1365.       Validation                    RACE                         Page 25
  1366.  
  1367.  
  1368.  
  1369.  
  1370.       6.6  Welcome message 
  1371.  
  1372.       A welcome message is automatically sent to a user when you upgrade 
  1373.       that user if you have enabled this feature during configuration.  
  1374.  
  1375.       If the message base is locked by another process when you  attempt
  1376.       to send a welcome message to a validated user, RACE will pause and 
  1377.       retry accessing the message  base  up  to  10  times.   If  access
  1378.       continues  to  be  denied, RACE will report this.  No harm is done
  1379.       and the user will get all the template upgrade  values  but  won't
  1380.       get the welcome message.  
  1381.  
  1382.       Included in the  distribution  package  are  five  sample  welcome
  1383.       messages and the supplied RACE.CFG file contains the proper set up 
  1384.       to use all five messages with the  possible  exception  being  the
  1385.       path.  
  1386.  
  1387.       Each welcome message file must have an  extension  that  coincides
  1388.       with  the  template that will use that message.  For example, when
  1389.       using template 1 to upgrade a user, RACE will look for WELCOME.001 
  1390.       in the path you have defined during configuration.  
  1391.  
  1392.       The confusion results from the fact that in  the  welcome  message
  1393.       setup,  the  path  is  defined like so: 'C:\RA\WELCOME'.  Note the
  1394.       absence of an extension on the filename.  This is so RACE can take 
  1395.       that filename and apply the proper extension based on the template 
  1396.       used.  If you use template 2 to upgrade the user, RACE  will  take
  1397.       that  path\filename  and  tack .002 onto the end, then go look for
  1398.       'C:\RA\WELCOME.002'.  
  1399.  
  1400.       If you don't care to have five different welcome messages,  delete
  1401.       all  but  WELCOME.001.   When RACE goes looking for the message it
  1402.       will read in WELCOME.001 if no others are found.  
  1403.  
  1404.       RACE does NOT perform any formatting on the welcome  message.   It
  1405.       will  be  imported  exactly as you have saved it.  Keep lines just
  1406.       under 80 characters and all will come out fine.  There is no limit 
  1407.       to the size of the message.  If you create a 100k welcome message, 
  1408.       RACE will import it.  
  1409.  
  1410.       If the welcome message feature is enabled, each time you update  a
  1411.       user  with  one  of  the  templates, RACE will ask: 'Send prepared
  1412.       message?'.  <Y> is the default and hitting <enter> is the same  as
  1413.       hitting <Y>.  
  1414.  
  1415.       If you say <N>, RACE will then provide a prompt and you may  enter
  1416.       ANY  other  text  file  for import as a welcome message.  You must
  1417.       provide the full path and filename of the file.   If  you  do  not
  1418.       wish  to  send  anything,  press  <enter> or <esc> at the filename
  1419.       prompt and RACE will exit the filename prompt.  
  1420.       
  1421.  
  1422.  
  1423.       Validation                    RACE                         Page 26
  1424.  
  1425.  
  1426.  
  1427.  
  1428.       6.7  Validation Menu Options 
  1429.  
  1430.       There are a number of items on the validation menu that you may or 
  1431.       may not want to use.  Some options will not  work  at  all  times.
  1432.       Which  items  are  enabled/disabled  all  depend on what method of
  1433.       Validation you are using at the time.  For instance, it would make 
  1434.       no  sense  to  attempt  to  'Save' a users answers if you have not
  1435.       defined the answer 'Save' file during configuration.  
  1436.  
  1437.       The menu items, in the order in which they are listed on the  menu
  1438.       are: 
  1439.  
  1440.            a.  <W>rite Cmts - As explained early, this is used to  force
  1441.                RACE  to  import  any comment lines into the user record.
  1442.                This would only be used if you  have  comment  lines  and
  1443.                have not used a template to upgrade the user.  
  1444.  
  1445.            b.  <N>ext - Move on to the next set  of  answers  and  user.
  1446.                This  only  works  in the <Ctrl-V> validation method.  If
  1447.                you use the <V>alidate method,  there  is  no  next  user
  1448.                since  the  <V>alidate method is used to upgrade the user
  1449.                you are currently viewing.  
  1450.  
  1451.            c.  <E>dit  -  This  allows you to manually edit the items in
  1452.                the  far  left  window  of  the  validation  screen.   As
  1453.                mentioned  earlier,  this  might  be  used if none of the
  1454.                templates quite fit the settings you wish  to  give  this
  1455.                particular user.  A small window pops up reminding you to 
  1456.                press CTRL-ENTER to save the edit or press ESC  to  abort
  1457.                any changes.  
  1458.  
  1459.            d.  <F>ind Answers - This  is  only  valid  in  the  <Ctrl-V>
  1460.                method  of validation and only if AUTO-SEARCH for answers
  1461.                has not been enabled during configuration.  
  1462.  
  1463.  
  1464.                Some SysOps use  RACE  Validation  routines  for  general
  1465.                upgrades  without answers from those users.  In that case
  1466.                Auto-Search should be disabled to avoid the constant  'No
  1467.                answers found for this user' prompt.  <F>ind then becomes 
  1468.                necessary to display the answers for those users that are 
  1469.                new and did answer a questionnaire.  
  1470.  
  1471.            e.  <S>ave Answers - If you have defined  an  answer  storage
  1472.                file  during  configuration and have Auto-Store disabled,
  1473.                this command will write the users answers to the  storage
  1474.                file.   This may be used if Auto-store is enabled, but it
  1475.                wouldn't make much sense to do so.  You would  then  have
  1476.                two  identical  sets  of answers for the same user in the
  1477.                storage file.  
  1478.       
  1479.  
  1480.  
  1481.       Validation                    RACE                         Page 27
  1482.  
  1483.  
  1484.  
  1485.  
  1486.            f.  <C>omment - Allows you to manually enter your own comment
  1487.                into the User comment field.  Previous versions  of  RACE
  1488.                put  this  comment  into the answer file.  Please keep in
  1489.                mind that using this option does not automatically  write
  1490.                the  comments  to the user record.  Using <W>rite Cmts or
  1491.                using a template to update the user will  write  manually
  1492.                entered comments to the user record.  
  1493.  
  1494.            g.  <Q>uit/Esc - Quit the validation function and  return  to
  1495.                the  main menu.  If you are using the <Ctrl-V> validation
  1496.                method, RACE will ask if you wish to  'Erase  the  answer
  1497.                file?'.   You  will  find  that RACE always starts at the
  1498.                beginning of the answers each  time  you  enter  <Ctrl-V>
  1499.                Validation.   If  you  never  delete  the answer file you
  1500.                spend increasingly more time going through users you have 
  1501.                previously validated.  
  1502.  
  1503.       
  1504.  
  1505.  
  1506.       User Reports                  RACE                         Page 28
  1507.  
  1508.  
  1509.  
  1510.  
  1511.         
  1512.  
  1513.  
  1514.                                   CHAPTER 7 
  1515.  
  1516.                                    Reports 
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.       7.1  The user report menu 
  1524.  
  1525.       RACE v1.30 brings an expanded reporting feature.  Previously there 
  1526.       was only a hard coded  user  list  and  custom  reports  were  not
  1527.       possible.  
  1528.  
  1529.       There are four  reporting  options  available.   The  first  three
  1530.       options  allow  a  wide  range  of  parameters that will provide a
  1531.       custom report.  The forth item, User List, is a  report  that  has
  1532.       its fields pre-defined and unchangeable.  
  1533.  
  1534.            a.  Screen - This option sends  the  output  to  the  screen,
  1535.                pausing  with  each  screenful.  You cannot page back and
  1536.                forth  through  the  report  with   this   option.    For
  1537.                non-permanent, custom reports when you want a quick look.  
  1538.  
  1539.            b.  Printer - Sends the report output to the printer  instead
  1540.                of  the screen.  This goes to LPT1 and cannot be changed.
  1541.                Also, page size is predefined as 54 lines.  When 54 lines 
  1542.                have  been  printed a form feed is sent to the printer to
  1543.                advance to the next page.  
  1544.  
  1545.  
  1546.                RACE checks to make sure the printer is  ok  both  before
  1547.                starting  and during the printout.  Continuous feed paper
  1548.                is assumed as RACE will not pause to allow you to  insert
  1549.                single sheets of paper.  
  1550.  
  1551.  
  1552.                If any of these printer limitations are  a  problem,  you
  1553.                may  want  to  use the next report option (disk file) and
  1554.                send the resulting ascii text file to your printer  after
  1555.                formatting the file as necessary.  
  1556.       
  1557.  
  1558.  
  1559.       User Reports                  RACE                         Page 29
  1560.  
  1561.  
  1562.  
  1563.  
  1564.            c.  Disk File - This option will allow you to send the report
  1565.                to an ascii disk file for processing or  storing  as  you
  1566.                see fit.  
  1567.  
  1568.  
  1569.                RACE prompts for a disk filename for the  report  and  if
  1570.                the file already exists, you will be asked if it is ok to 
  1571.                overwrite the existing file.  
  1572.  
  1573.  
  1574.                Note that although RACE  does  not  specifically  support
  1575.                paths  for  the  disk report filename, you may use one if
  1576.                the full  path  and  filename  will  fit  within  the  25
  1577.                character limitation of the filename prompt.  
  1578.  
  1579.            d.  User list - This option is handy  for  quick  lookups  of
  1580.                users.   All  fields  are  predefined  and  there  are no
  1581.                prompts/questions to answer.  The  cursor  movement  keys
  1582.                will move you around the user list screen.  
  1583.  
  1584.  
  1585.                You may move the highlight bar to  a  user  in  the  list
  1586.                screen  and  press  <enter> to go directly to that user's
  1587.                record.  Also, you may delete or undelete a user in  this
  1588.                screen.   Simply  highlight the user and press your <DEL>
  1589.                key to toggle delete ON/OFF.  
  1590.  
  1591.  
  1592.                Users are listed in a Lastname,Firstname fashion  in  the
  1593.                User  List  screen.   This will facilitate easy searching
  1594.                for a user.  By simply typing a last name RACE will  move
  1595.                the  highlight  bar  to each user as it finds a match for
  1596.                the letters you type.  If you're a speed typist, you  may
  1597.                want to slow down a bit for this function to work best.  
  1598.  
  1599.  
  1600.  
  1601.       7.2  Report options 
  1602.  
  1603.       All  report field and search options are identical for each of the
  1604.       three types of custom reports, i.e.  screen, printer or disk file.  
  1605.       
  1606.  
  1607.  
  1608.       User Reports                  RACE                         Page 30
  1609.  
  1610.  
  1611.  
  1612.  
  1613.       7.3  Field Selection 
  1614.  
  1615.       Once  you  have  decided  on whether you want a screen, printer or
  1616.       disk file report, RACE will take you to the window in which you'll 
  1617.       select the fields to include in the report.  
  1618.  
  1619.       Fields are not placed into the report in the order in  which  they
  1620.       are  chosen,  instead,  they  go  into  the  report based on their
  1621.       position in the selection window.  
  1622.  
  1623.       Move the highlight bar using the cursor keys or  by  pressing  the
  1624.       first  letter  of  the  item  you  wish  to  choose.  For example,
  1625.       pressing <A> will first move the highlight bar to Alias.  Pressing 
  1626.       <A>  a  second time will move the bar to the next item that begins
  1627.       with the letter 'A', in this case, A1 Flag.  
  1628.  
  1629.       Pressing <enter> on a desired  field  will  select  that  item  or
  1630.       deselect it if it was previously selected.  As you select/deselect 
  1631.       items, the display on line 25 will dynamically change to show  you
  1632.       how  the  report  will  appear.   You  cannot  have  more  than 79
  1633.       characters per report line.  
  1634.  
  1635.       As mentioned in section 3.5(f) of  the  configuration  information
  1636.       you  may  shorten  up  the user name field to allow more fields in
  1637.       each report line.  
  1638.  
  1639.       When you have selected all the items you wish to have included  in
  1640.       your  report,  press  <ESC>  to  exit  the selection window.  Upon
  1641.       exiting the field selection window you will be  given  the  search
  1642.       selection menu.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.       7.4  Report Searching 
  1648.  
  1649.       After choosing the fields to include in the custom report you have 
  1650.       the option of narrowing the report to include only certain  users.
  1651.       If  you  wish  to  include all users, merely hit <ESC> to exit the
  1652.       search window, otherwise, select the desired search item from  the
  1653.       menu.  
  1654.  
  1655.       A user's data will be included in your report  only  if  the  user
  1656.       record matches the search criteria you have provided.  
  1657.  
  1658.       Please see chapter 8 for particulars on search parameters.  Report 
  1659.       searching  works  exactly  like the main menu search function with
  1660.       two exceptions.  RACE does not pause at each user it finds and you 
  1661.       cannot abort the search by pressing <S>.  
  1662.  
  1663.       
  1664.  
  1665.  
  1666.       User Search                   RACE                         Page 31
  1667.  
  1668.  
  1669.  
  1670.  
  1671.         
  1672.  
  1673.  
  1674.                                   CHAPTER 8 
  1675.  
  1676.                                   Searching 
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.       8.1  The Search Menu 
  1684.  
  1685.       Upon selecting search at the RACE main menu a second menu will pop 
  1686.       up in the middle of the screen.   It  is  from  this  menu  you'll
  1687.       select  the  user  record  field to search on and depending on the
  1688.       field, you will be prompted for additional data before the  search
  1689.       begins.  
  1690.  
  1691.  
  1692.  
  1693.       8.2  Search Operation 
  1694.  
  1695.       RACE  always  begins  the  search with the first user.  It doesn't
  1696.       matter which user you are viewing when you invoke a search and  it
  1697.       is  not  necessary  for  you to first move to the beginning of the
  1698.       user file before starting a search.  
  1699.  
  1700.       Once RACE is in search mode, the search is  considered  to  be  in
  1701.       force until one of two things happen: 
  1702.  
  1703.            1.  The end of the user file is reached.  
  1704.  
  1705.            2.  You abort the search by pressing 'S' a second time.  
  1706.  
  1707.       RACE stops at each match during a search.  At that  time  you  may
  1708.       edit  the  user  record just found or you may elect to continue to
  1709.       the  next  match.   To  do  so  use  the  <N>ext  command  or  the
  1710.       <right-arrow> key.  
  1711.  
  1712.       Once you've found the record  you're  looking  for,  press  'S'  a
  1713.       second  time  to  take  RACE  out  of  search  mode.   This is not
  1714.       absolutely necessary, but remember  that  RACE  will  continue  to
  1715.       search with every forward movement through the user file until the 
  1716.       last user is reached or until you abort the search.  
  1717.  
  1718.       
  1719.  
  1720.  
  1721.       User Search                   RACE                         Page 32
  1722.  
  1723.  
  1724.  
  1725.  
  1726.       8.3  Search options 
  1727.  
  1728.       RACE v1.30 has expanded the number of fields that may be searched. 
  1729.       In  addition,  numeric  fields allow you to select whether to view
  1730.       all matches only if they are greater than, lesser than or equal to 
  1731.       the number you provide.  
  1732.  
  1733.  
  1734.  
  1735.       8.4  Name/Alias 
  1736.  
  1737.       When  selecting  this  item  you  will be prompted for the Name or
  1738.       Alias to search for.  Keep in mind that the  search  is  not  case
  1739.       sensitive.  You may enter the search text in upper or lowercase or 
  1740.       any combination of both.  
  1741.  
  1742.       RACE searches both the name and the alias field  so  there  is  no
  1743.       prompting for which field you wish to search.  
  1744.  
  1745.       RACE performs what may be called an INSTRING search.  That is,  if
  1746.       the  text  you  enter is contain ANYWHERE within the name or alias
  1747.       string, RACE will consider it a match.  
  1748.  
  1749.       For example, if you enter BERT as the search text, RACE would find 
  1750.       users with the name BERT Simpson, Joe AlBERTson or AlBERT Smith.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.       8.5  City/Phone/Password 
  1756.  
  1757.       Like  the  Name/Alias  search, the city, phone and password fields
  1758.       are all string  data  and  will  take  search  data  in  upper  or
  1759.       lowercase and will work well when provided with only partial data.  
  1760.  
  1761.       If, for instance, you wanted to find all users that lived in  your
  1762.       area  code  you  may  enter  something like 305- when prompted for
  1763.       phone data to search for.  This would show you all users that  had
  1764.       a  phone  number  with  305-  anywhere within the two phone fields
  1765.       provided in Users.bbs.  
  1766.  
  1767.  
  1768.  
  1769.       8.6  Security/Group 
  1770.  
  1771.       When selecting either Security or Group for a search you  will  be
  1772.       asked  if  you wish to search for matches that are "Greater than",
  1773.       "Less than" or "Equal to" a number you provide.  This  will  allow
  1774.       you to find very specific sets of users.  
  1775.       
  1776.  
  1777.  
  1778.       User Search                   RACE                         Page 33
  1779.  
  1780.  
  1781.  
  1782.  
  1783.       8.7  Upload/Downloads 
  1784.  
  1785.       Like Security and Group, you will be prompted for additional  data
  1786.       before you input the amount to search for.  Unlike security/group, 
  1787.       you do not have the "Equal to" option for a search.   It  is  very
  1788.       unlikely  that anyone would want to find a user that down/uploaded
  1789.       an exact amount of Kilobytes and so that option is not provided.  
  1790.  
  1791.  
  1792.  
  1793.       8.8  Flags 
  1794.  
  1795.       Searching for users with specific flags set on or off will require 
  1796.       a  little care on your part during entry of the search data.  RACE
  1797.       parses the flag data you input and expects to find it  in  a  very
  1798.       specific format.  
  1799.  
  1800.       The form RACE looks for during Flag search input is: 
  1801.  
  1802.       {FLAGLETTER}{FLAGNUMBER}{SPACE}{ON/OFF} 
  1803.  
  1804.       For example, if you wanted to find all users that have flag A1 set 
  1805.       to  ON,  when  selecting  "Flags" on the search menu and then when
  1806.       prompted for "Flag: " your input to the prompt  should  look  like
  1807.       this: 
  1808.  
  1809.       Flag: A1 ON 
  1810.  
  1811.       You may only search for one flag at a time.  As with elsewhere  in
  1812.       the search function, upper or lowercase is ok during input.  
  1813.  
  1814.       If the flag search data is  entered  incorrectly,  RACE  will  not
  1815.       report  an  error.   No  harm  is  done except for the time wasted
  1816.       searching for data that doesn't exist.  
  1817.  
  1818.       There is a chance RACE may present you with what it  thinks  is  a
  1819.       match if you input flag data incorrectly.  This is unlikely but if 
  1820.       it does find something, that match is most likely invalid.  
  1821.  
  1822.       In most cases of invalid flag input, RACE will reach  the  end  of
  1823.       the user file and report "No matching data found".  
  1824.  
  1825.       
  1826.  
  1827.  
  1828.       User Flags                    RACE                         Page 34
  1829.  
  1830.  
  1831.  
  1832.  
  1833.         
  1834.  
  1835.  
  1836.                                   CHAPTER 9 
  1837.  
  1838.                                Global changes 
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.       9.1  General Information 
  1846.  
  1847.       RACE  provides the means to change one or more flags or attributes
  1848.       for every user of your bbs.  The option to change Group numbers is 
  1849.       also provided.  
  1850.  
  1851.       When selecting <C>hanges  at  the  RACE  main  menu  you  will  be
  1852.       required  to select <A>ttribute flags, <S>ecurity flags or <G>roup
  1853.       changes from a pop up menu.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.       9.2  Attribute Flags 
  1859.  
  1860.       Attribute  flags  are  items such as: Clear Screen, Ansi Graphics,
  1861.       Full Screen Editor, etc., etc.  These settings are unique to  each
  1862.       user  and the SysOp will rarely have a need to make global changes
  1863.       to any of these settings.  Nevertheless, the  option  is  provided
  1864.       for those rare instances.  
  1865.  
  1866.       When selecting Attributes from the pop up menu you will be  placed
  1867.       into  a  window listing all attributes.  In addition, three fields
  1868.       are provided to allow you  to  limit  changes  based  on  Security
  1869.       levels   and/or  Group  number.   See  section  9.5  for  specific
  1870.       information on using the security/group options.  
  1871.  
  1872.       Attributes have a box next to them that looks like this: [ ].  The 
  1873.       box  initially contains nothing which means that attribute will be
  1874.       unaffected during global changes.  
  1875.  
  1876.       Use the arrow keys to move up and down the list of attributes.  If 
  1877.       you  wish  to  globally toggle an attribute, enter a "Y" for ON or
  1878.       "N" for OFF.  use the <spacebar> to erase a "Y" or "N".  
  1879.       
  1880.  
  1881.  
  1882.       User Flags                    RACE                         Page 35
  1883.  
  1884.  
  1885.  
  1886.  
  1887.       9.3  Security Flags 
  1888.  
  1889.       RACE  provides  the  ability to toggle any number of user security
  1890.       flags on or off with the greatest of ease.  
  1891.  
  1892.       Upon entering the global security flag change window you will note 
  1893.       that  all  four  flags  are  initially  filled  with the numbers 1
  1894.       through 8.  This is to allow easy movement  to  the  desired  flag
  1895.       without  having  to carefully count as you move to the flag number
  1896.       you wish to change.  
  1897.  
  1898.       If you have "Flag notes" enabled (Chapter  3,  Section  3.7),  the
  1899.       flag  note  window will appear just as it does when editing a user
  1900.       record.  
  1901.  
  1902.       Move to the flag position you wish to globally change and type  an
  1903.       "X" to turn that flag ON or type a "-" to turn the flag OFF.  Note 
  1904.       that if you change your mind you  can  merely  type  the  original
  1905.       number back in that position.  
  1906.  
  1907.       After selecting the flag(s) you wish changed  you  may  limit  the
  1908.       changes by Group number or security level.  Please see Section 9.5 
  1909.       below for information on these options.  
  1910.  
  1911.  
  1912.  
  1913.       9.4  Group Changes 
  1914.  
  1915.       Selecting Group changes from the pop-up <C>hanges menu  opens  yet
  1916.       another  window  in  which  you  may  enter  parameters to use for
  1917.       performing global group changes.  
  1918.  
  1919.       The first item in the global group change window is  'New  group'.
  1920.       This  is  the  group number you wish to assign to users that match
  1921.       the parameters provided in the security  level  and  group  number
  1922.       fields.   These  fields  are  explained in detail in the following
  1923.       section.  
  1924.  
  1925.  
  1926.  
  1927.       9.5  Global Changes and Group/Security levels 
  1928.  
  1929.       Global changes may be limited to a select group of users based  on
  1930.       their  security  level  and/or Group number.  The default settings
  1931.       upon entering the  attribute,  security  or  group  global  change
  1932.       screen  is to apply the changes to all users with a security level
  1933.       less than 64000 and ignore group numbers.  
  1934.       
  1935.  
  1936.  
  1937.       User Flags                    RACE                         Page 36
  1938.  
  1939.  
  1940.  
  1941.  
  1942.       There are four modifiers that may be  entered  to  determine  what
  1943.       security  levels  you  wish to apply the global changes on.  These
  1944.       are entered by you as a character.  The four choices are: 
  1945.  
  1946.            1.  "A"  -  Apply  changes  to  ALL users regardless of their
  1947.                security level.  
  1948.  
  1949.            2.  "<"  -  Apply changes to users with a security level LESS
  1950.                THAN the number you provided in the Access field.  
  1951.  
  1952.            3.  ">"  -  Apply  changes  to  users  with  a security level
  1953.                GREATER THAN the number you provided in the Access field.  
  1954.  
  1955.            4.  "=" - Apply changes to users only if their security level 
  1956.                EXACTLY matches that which you  provided  in  the  Access
  1957.                field.  
  1958.  
  1959.       If you enter "A" as the modifier character, this means you wish to 
  1960.       apply the changes to ALL users regardless of their security level. 
  1961.       If you use the "A" modifier it does not matter what number appears 
  1962.       in the security level field in the global change screen.  
  1963.  
  1964.       The Group setting provides another means for limiting the users to 
  1965.       which the changes will be applied.  A -1 (minus one) in this field 
  1966.       indicates you want RACE to ignore the user group number and  apply
  1967.       changes  based  only  on  the  access  level and modifier you have
  1968.       provided.  
  1969.  
  1970.       If you place a group number in the field AND have set  a  security
  1971.       level  limitation,  the user must be in that group number AND meet
  1972.       the security parameters before changes will apply.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.       9.6  Executing global changes 
  1978.  
  1979.       Once  you  have  made  all  your selections, press <Ctrl-Enter> to
  1980.       continue.  If you  decide  you  really  don't  want  to  make  the
  1981.       changes, press <ESC> to abort back to the main menu.  
  1982.  
  1983.       If you do continue, RACE will ask "Execute  these  changes?"   Hit
  1984.       <enter>  or "Y" to go on and RACE will make the necessary changes.
  1985.       This takes very little time, even on large user files.  
  1986.  
  1987.       
  1988.  
  1989.  
  1990.       Adding New Users              RACE                         Page 37
  1991.  
  1992.  
  1993.  
  1994.  
  1995.         
  1996.  
  1997.  
  1998.                                  CHAPTER 10 
  1999.  
  2000.                                 Add New User 
  2001.  
  2002.  
  2003.  
  2004.       Adding a new user manually is the same as editing an existing user 
  2005.       record.  
  2006.  
  2007.       Press <A>dd or your INSert key and RACE will open a new record and 
  2008.       place you into edit mode on that record.  
  2009.  
  2010.       A few of the  fields  are  filled  and  two  of  those,  Name  and
  2011.       Location,  are  merely cosmetic filler.  The name is initially set
  2012.       to "New User" and the location is  filled  with  "Somewhere".   Of
  2013.       course  you'll  want to edit these fields and insert more accurate
  2014.       information.  
  2015.  
  2016.       Three of the other fields are filled with information you may wish 
  2017.       to leave as is, but of course you may edit these fields to contain 
  2018.       any value you desire.  
  2019.  
  2020.       The Screen length setting is set to 24  since  this  is  the  most
  2021.       common  setting.   The  Last Date and First Date fields are filled
  2022.       with the current date as obtained from DOS.  If your  system  date
  2023.       is incorrect you will probably want to edit these fields.  
  2024.  
  2025.       Most numeric fields are initialized to zero and all attributes are 
  2026.       set to OFF.  
  2027.  
  2028.       Once you have edited the new user  record  to  your  satisfaction,
  2029.       press  <Ctrl-Enter>  to  save  the  record.   If  you  press <ESC>
  2030.       instead, the record will be discarded and will not be appended  to
  2031.       your user file.  
  2032.  
  2033.       Upon exiting this screen you will be returned to the user you were 
  2034.       viewing when you invoked the <A>dd command.  
  2035.  
  2036.       
  2037.  
  2038.  
  2039.       Running External Programs     RACE                         Page 38
  2040.  
  2041.  
  2042.  
  2043.  
  2044.         
  2045.  
  2046.  
  2047.                                  CHAPTER 11 
  2048.  
  2049.                                  Jump/Utils 
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.       11.1  General information 
  2058.  
  2059.       Whether  running  a  predefined  program or simply jumping to dos,
  2060.       RACE can free up most of the memory it uses by swapping itself  to
  2061.       disk  or EMS if available.  Note that the decision to use the disk
  2062.       or EMS is determined by RACE and is  not  user  selectable.   RACE
  2063.       will swap to EMS if at all possible.  
  2064.  
  2065.       RACE will only swap if  you  have  defined  a  swap  file  through
  2066.       RACECFG.   If swap space is not available when RACE is run, either
  2067.       because of insufficient disk space or a bad path name,  RACE  will
  2068.       disable  swapping.  You may still use <J>ump or <U>tils, RACE just
  2069.       won't be able to free up memory for those commands.  
  2070.  
  2071.       RACE always uses the command processor for both the Jump and Utils 
  2072.       and   it   gets   the   information  it  needs  from  the  COMSPEC
  2073.       environmental variable.  So, if you use 4DOS or some other command 
  2074.       processor  instead  of  DOS  Command.com,  RACE will still operate
  2075.       properly.  
  2076.  
  2077.  
  2078.  
  2079.       11.2  Jump 
  2080.  
  2081.       Jump, or shell to dos, puts you at the dos prompt where you may do 
  2082.       whatever  dos  work  you need to do.  The user file is closed when
  2083.       you exit in this manner, and you can do anything you like with the 
  2084.       user file while in the dos shell.  
  2085.       
  2086.  
  2087.  
  2088.       Running External Programs     RACE                         Page 39
  2089.  
  2090.  
  2091.  
  2092.  
  2093.       11.3  Utilities 
  2094.  
  2095.       As you  know  from  configuration,  you  have  the  capability  of
  2096.       predefining  up  to ten external programs to run from within RACE.
  2097.       Like the Jump command, the user file is closed so that you may run 
  2098.       any program you like.  
  2099.       
  2100.  
  2101.  
  2102.       Pack/Sort                     RACE                         Page 40
  2103.  
  2104.  
  2105.  
  2106.  
  2107.         
  2108.  
  2109.  
  2110.                                  CHAPTER 12 
  2111.  
  2112.                       Packing and Sorting the User file 
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.       12.1  General Information 
  2120.  
  2121.       RACE has a built in packing and sorting option and while it is not 
  2122.       usable as a command line driven batch file type of  utility,  both
  2123.       options have some features which you may find quite useful.  
  2124.  
  2125.       Both the Pack and Sort options will have to create temporary files 
  2126.       and  so  will need disk space relative to the current size of your
  2127.       user files.  RACE will attempt  to  calculate  the  current  space
  2128.       available  and abort with the message "Insufficient disk space" if
  2129.       not enough space is found.  This space is calculated for the drive 
  2130.       on which your user files reside, not the drive from which RACE was 
  2131.       executed.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.       12.2  Pack/Sort Menu 
  2137.  
  2138.       The  Pack/Sort  menu  is  accessed  from  the  main VIEW screen by
  2139.       pressing <Ctrl-P>.  If a user is currently online, RACE  will  not
  2140.       allow  this  menu  to  pop-up.   Instead  RACE  will report, "User
  2141.       online, PACK disabled."  Packing or sorting the user file  with  a
  2142.       user online would most likely destroy your Users.bbs file.  
  2143.  
  2144.       After bringing up the pack menu, each of the four  main  items  on
  2145.       the  menu may be accessed by pressing the first letter of the menu
  2146.       option or by using your cursor keys to move the highlight  to  the
  2147.       desired option and then pressing <enter>.  
  2148.  
  2149.       RACE does not provide the option of packing and sorting  with  one
  2150.       operation.  Each of these items must be selected individually.  
  2151.  
  2152.       
  2153.  
  2154.  
  2155.       Pack/Sort                     RACE                         Page 41
  2156.  
  2157.  
  2158.  
  2159.  
  2160.       12.3  PACK 
  2161.  
  2162.       Selecting pack will pull down a second  menu  with  four  options.
  2163.       These options, in the order in which they appear on the menu, are: 
  2164.  
  2165.            1.  BEGIN PACK - This starts the packing procedure.  If  none
  2166.                of  the  other 3 options are set, this is a straight pack
  2167.                that will only remove users that are  flagged  [deleted].
  2168.                Users  that  have  the NO-KILL flag set to ON will not be
  2169.                packed out unless the fourth menu option, HONOR  NO-KILL,
  2170.                is set to NO.  More on that later.  
  2171.  
  2172.            2.  AGE PARAMETER - This option will allow you to pack  users
  2173.                out  of  your users.bbs based on the amount of time since
  2174.                their last call to your bbs.  
  2175.  
  2176.  
  2177.                Select this option BEFORE you begin the  pack  and  enter
  2178.                the  number  of days to use as a deciding factor.  If you
  2179.                use this option but do not manually enter a value for the 
  2180.                Security  parameter, all security levels will be affected
  2181.                because the default is to examine all users with security 
  2182.                levels from 0 to 64000.  
  2183.  
  2184.  
  2185.                An AGE parameter of zero (this is the  default)  disables
  2186.                age checking and this is the number you should use if you 
  2187.                wish to disable the  age  parameter  after  making  it  a
  2188.                non-zero number.  
  2189.  
  2190.  
  2191.  
  2192.            3.  SECURITY PARAMETER  -  You  will  note  that  upon  first
  2193.                pulling  down  the  Pack  option menu the words "Security
  2194.                Parameter" appear in a different color.  Also, if you try 
  2195.                to  move the highlight bar through the menu the "Security
  2196.                Parameter" is skipped over.   This  indicates  that  this
  2197.                item is disabled unless you first enter an AGE PARAMETER. 
  2198.                The security and age  parameter  were  designed  to  work
  2199.                together  and  you  cannot  pack  based on security alone
  2200.                although you can pack based on age alone.  
  2201.  
  2202.  
  2203.                Select this item if so  desired  and  enter  the  MAXIMUM
  2204.                security level that should be affected by the current AGE 
  2205.                parameter.  If you enter the number 10, no  user  with  a
  2206.                security  level  of  11 or higher will be affected by the
  2207.                pack unless they  are  flagged  [deleted].   The  default
  2208.                setting for this item is 64000.  
  2209.  
  2210.       
  2211.  
  2212.  
  2213.       Pack/Sort                     RACE                         Page 42
  2214.  
  2215.  
  2216.  
  2217.  
  2218.            4.  HONOR NO-KILL - This  menu  item  allows  you  to  decide
  2219.                whether  or  not a NO-KILL flag will protect a user.  The
  2220.                default is YES.  If left  set  to  YES,  a  user  flagged
  2221.                NO-KILL  will  NEVER be removed by the RACE pack function
  2222.                even if that user is flagged [deleted].  If  set  to  NO,
  2223.                the  NO-KILL  flag is ignored though the age and security
  2224.                parameters would still be in force if they are in use.  
  2225.  
  2226.  
  2227.  
  2228.       12.4  SORT 
  2229.  
  2230.       RACE can sort your users.bbs on any one  of  6  different  fields.
  2231.       RACE  will  only  sort  on ONE field, not a combination of fields.
  2232.       That means that, unlike  the  RemoteAccess  RAUSER  utility,  RACE
  2233.       cannot sort on last names within security levels.  
  2234.  
  2235.       Under no circumstances is the record in the first position of  the
  2236.       users.bbs ever included in a sort.  This record should contain the 
  2237.       SysOp record and this must remain record zero.  
  2238.  
  2239.       RACE will sort the following fields in a user selectable ascending 
  2240.       or descending order: 
  2241.  
  2242.          * Last Name 
  2243.  
  2244.          * Security Level 
  2245.  
  2246.          * Upload K 
  2247.  
  2248.          * Download K 
  2249.  
  2250.          * Times Called 
  2251.  
  2252.          * Message posts 
  2253.  
  2254.       Select  the field you wish to have the sort work with and you will
  2255.       then select an ascending or descending sort.  After this option is 
  2256.       chosen you are given the opportunity to cancel the sort.  
  2257.  
  2258.       Upon completion of the sort you may notice  the  user  record  you
  2259.       were  viewing  change  to another user's data.  That's because you
  2260.       remain within the same record number in the VIEW screen,  but  the
  2261.       sort  may  have  placed  another  user  in that position.  This is
  2262.       normal.  
  2263.       
  2264.  
  2265.  
  2266.       Pack/Sort                     RACE                         Page 43
  2267.  
  2268.  
  2269.  
  2270.  
  2271.       12.5  Whoops!  
  2272.  
  2273.       Whenever  the  RACE pack option is used and users are removed from
  2274.       your  users.bbs,  RACE  places  those  users  in  a  file   called
  2275.       Users.old.   This  file  has the exact same structure as Users.bbs
  2276.       and this will  allow  you  to  retrieve  users  with  the  Whoops!
  2277.       option.  
  2278.  
  2279.       You might find Whoops!  useful if, for example, you forgot to  set
  2280.       a  user's  No-Kill  flag  and  you watched as the user was removed
  2281.       during a pack.  
  2282.  
  2283.       Users.old is placed in the same directory as Users.bbs.   Keep  in
  2284.       mind  that ONLY RACE creates and maintains this file.  If you pack
  2285.       your user  file  with  any  other  utility,  this  option  is  not
  2286.       available to you.  
  2287.  
  2288.       RACE appends packed users to Users.old and does not maintain  this
  2289.       file  in  any  other way.  If the same user keeps calling back and
  2290.       you keep  deleting  him,  that  user's  record  could  end  up  in
  2291.       Users.Old multiple times.  It's a good idea to keep an eye on this 
  2292.       file or it could grow quite large if you delete a lot of users.  
  2293.  
  2294.  
  2295.       Selecting Whoops!  pulls down a menu with just two  options.   The
  2296.       first  option,  "Restore  Users"  is the main function of Whoops!.
  2297.       The second option, "Delete Users.Old" is a  convenience  function.
  2298.       You  could  easily  delete  Users.old  from dos, but the option is
  2299.       there if you need it.  
  2300.       
  2301.  
  2302.  
  2303.       Pack/Sort                     RACE                         Page 44
  2304.  
  2305.  
  2306.  
  2307.  
  2308.            1.  RESTORE USERS - Select this option and yet another window 
  2309.                opens  up  in  the  middle  of  the  screen.  This window
  2310.                contains the first 20 users  that  are  contained  within
  2311.                Users.old.  You may scroll through the list using all the 
  2312.                cursor keys.  You may also type a user name and RACE will 
  2313.                search  through the list.  Note that the search begins on
  2314.                the FIRST name, not the last.  
  2315.  
  2316.  
  2317.                Move the highlight bar to the user you  wish  to  restore
  2318.                and  press  <enter>.   RACE will first check to make sure
  2319.                that this user name  isn't  already  in  your  Users.bbs.
  2320.                Duplicate  name  records could be a problem.  If the name
  2321.                is a duplicate, you will be told so  and  RACE  will  not
  2322.                restore that user.  
  2323.  
  2324.  
  2325.                When a user is restored, all the info that  was  in  that
  2326.                user's  Users.bbs  record  is restored as it was when the
  2327.                user was removed during the pack.  This means that if the 
  2328.                user  was  marked  [deleted] the restored record is still
  2329.                marked  [deleted].   New  records  for  Lastread.bbs  and
  2330.                Usersxi.bbs are created for restored users.  
  2331.  
  2332.            2.  DELETE USERS.OLD As the menu option  name  implies,  this
  2333.                will  delete  the  Users.old file after confirmation from
  2334.                you.  
  2335.  
  2336.  
  2337.                If Users.old does not exist, this menu option will appear 
  2338.                in  a  different color and you will not be able to select
  2339.                it.  
  2340.       
  2341.  
  2342.  
  2343.       Appendix A                    RACE                         Page 45
  2344.  
  2345.  
  2346.  
  2347.  
  2348.                                  PROBLEMS?  
  2349.  
  2350.       If you are having difficulties running RACE  or  if  a  particular
  2351.       feature doesn't appear to work as you think it should, please read 
  2352.       this section first.  The answer to your  problem  might  be  right
  2353.       here.  
  2354.  
  2355.       If RACE ever ends with an error message, look for  a  file  called
  2356.       RACE.ERR.   This  file  will  contain  info  on the type of error.
  2357.       While not too useful to the average user, this info will be needed 
  2358.       if you wish to make a bug report to me.  
  2359.  
  2360.  
  2361.  
  2362.       Q.  When I run RACE it beeps and says "Race.cfg disk read error".  
  2363.  
  2364.  
  2365.       A.  This occurs when RACE finds LESS  data  in  the  configuration
  2366.       file  than  should be there.  Make sure you have a RACE.CFG with a
  2367.       file size of 2916 bytes.  This will probably only occur  with  new
  2368.       installations  by  users of RACE v1.20.  You may have forgotten to
  2369.       convert  your  RACE  v1.20  configuration  to  v1.30  format  with
  2370.       120to130.exe.   If the problem is persistent and you can't seem to
  2371.       get around it, delete RACE.CFG.  Then  run  RACECFG.EXE  and  when
  2372.       this  program  says  "Race.cfg not found, create it?"  answer "Y".
  2373.       You will then have to reconfigure the setup.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.       Q.  RACE tells me a user is online and I cannot edit his record or 
  2379.       perform any global flag changes but no one is online!  
  2380.  
  2381.  
  2382.       A.  At  one  time  or  another,  RemoteAccess  (your  BBS)   ended
  2383.       abnormally  and  could not update the USERON.BBS file.  This could
  2384.       happen if your system rebooted for whatever reason  while  a  user
  2385.       was  online.   Delete the USERON.BBS file and RACE will work fine.
  2386.       RemoteAccess will recreate the USERON.BBS file as soon as  a  user
  2387.       logs on.  
  2388.  
  2389.  
  2390.       
  2391.  
  2392.  
  2393.       Appendix A                    RACE                         Page 46
  2394.  
  2395.  
  2396.  
  2397.  
  2398.       Q.  I've  set  up  all  the  new  user  templates but when I use a
  2399.       template to upgrade a user, flags I have set to turn off  are  not
  2400.       turned off.  
  2401.  
  2402.  
  2403.       A.  Check your templates and make sure  that  you  have  used  the
  2404.       letter  "O"  in  the  flag  positions  you  want  turned OFF.  The
  2405.       template setup is the only area that doesn't use the "-"  (hyphen)
  2406.       to signify you want a flag turned off.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.       Q.  I can't get the template NO-KILL or XFER  PRIORITY  attributes
  2412.       to  turn  OFF automatically when I'm in the Validate section and I
  2413.       use a template to update a user.  
  2414.  
  2415.  
  2416.       A.  This is normal.  These template settings  cannot  be  used  to
  2417.       turn  these  two  attribute  flags OFF.  Since new users initially
  2418.       start out with these attributes OFF, it was felt that these  flags
  2419.       would  only  be turned ON during upgrades.  Use <Alt-X> or <Alt-N>
  2420.       to toggle these items.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.       Q.  When I run <R>eports, I  can't  seem  to  get  the  user  name
  2426.       included in the report.  I select it but it never appears.  
  2427.  
  2428.  
  2429.       A.  Run RACECFG.EXE then go to the  "Miscellaneous"  selection  on
  2430.       the  main  menu.   Check  the  item  labeled  "Name  field size in
  2431.       reports".  It should contain a number from 1 to  35.   It  is  not
  2432.       possible  to  enter  a  number  less than 1 or greater than 35 but
  2433.       there is a very remote chance the field is corrupt and contains  a
  2434.       number  out  of  range.   Set  the  value  to a reasonable amount.
  2435.       Obviously, if you set the name size to 1 you  will  only  get  one
  2436.       letter  of  the  user's name in reports and it would seem that the
  2437.       name is not appearing.  
  2438.       
  2439.  
  2440.  
  2441.       Appendix A                    RACE                         Page 47
  2442.  
  2443.  
  2444.  
  2445.  
  2446.       Q.  When I update a user in <V>alidate, RACE asks me if I want  to
  2447.       send  a  predefined message.  I say "Y", then RACE reports that it
  2448.       can't find the message file.  
  2449.  
  2450.  
  2451.       A.  The best suggestion for this problem is to go back and re-read 
  2452.       Chapter 6,  Section  6.6.  This  gives a  complete  explanation of
  2453.       the filenaming convention used for welcome messages.  Improper set 
  2454.       up has proven to be the most common problem.  
  2455.  
  2456.  
  2457.  
  2458.  
  2459.       Q.  All the user passwords have disappeared!  
  2460.  
  2461.  
  2462.       A.  If you cannot see passwords within RACE then you should  first
  2463.       try  pressing  <Alt-F10>  within  RACE.  This will toggle password
  2464.       display ON if it is OFF and vice versa.  If you can  now  see  the
  2465.       passwords  you  may  want to make this permanent by configuring it
  2466.       into RACE.  Run RACECFG.EXE and go to the  Miscellaneous  section.
  2467.       There you will find "Hide passwords in view mode".  This should be 
  2468.       set to "N" if you want to have passwords displayed at all times.  
  2469.  
  2470.  
  2471.  
  2472.  
  2473.       Q.  RACE runs ok, but some options report "Insufficient memory".  
  2474.  
  2475.  
  2476.       A.  There is no way for RACE to know beforehand what items you may 
  2477.       wish to use.  The memory requirements for RACE will vary depending 
  2478.       on what options you try to use because RACE will use  more  memory
  2479.       only  if  it is needed.  This method is much better than requiring
  2480.       the maximum memory at all times.  This would  force  you  to  have
  2481.       250-300k  of ram free for all RACE options even if you just wanted
  2482.       to take a quick look at one user.  
  2483.  
  2484.  
  2485.       
  2486.  
  2487.  
  2488.       Appendix B                    RACE                         Page 48
  2489.  
  2490.  
  2491.  
  2492.  
  2493.                     Field editing and movement keystrokes 
  2494.  
  2495.       The following FIELD EDITING COMMANDS are available  in  all  field
  2496.       input  prompts  within RACE.  This includes all of the user fields
  2497.       in the user editor, prompts for search data, etc.  
  2498.  
  2499.       For movement among  fields  and  to  save  edited  data  or  abort
  2500.       changes,  see  Field movement and Exit commands towards the end of
  2501.       this section.  
  2502.  
  2503.                            FIELD EDITING COMMANDS 
  2504.  
  2505.       <Left>, <CtrlS> 
  2506.       Cursor left one character.  
  2507.  
  2508.       <Right>, <CtrlD> 
  2509.       Cursor right one character.  
  2510.  
  2511.       <CtrlLeft>, <CtrlA> 
  2512.       Cursor  left  one  word.   A  'word'  is  a  series  of  non-blank
  2513.       characters followed by one or more blanks.  
  2514.  
  2515.       <CtrlRight>, <CtrlF> 
  2516.       Cursor right one word.  
  2517.  
  2518.       <Home>, <CtrlQ><S> 
  2519.       Cursor to beginning of field.  
  2520.  
  2521.       <End>, <CtrlQ><D> 
  2522.       Cursor to end of field.  
  2523.  
  2524.       <Del>, <CtrlG> 
  2525.       Delete character at cursor.  
  2526.  
  2527.       <Bksp>, <CtrlH>, <CtrlBksp> 
  2528.       Delete character to left of cursor.  
  2529.  
  2530.       <CtrlY> 
  2531.       Clear entire field.  
  2532.  
  2533.       <CtrlEnd>, <CtrlQ><Y> 
  2534.       Delete from cursor to end of subfield.  
  2535.  
  2536.       <CtrlHome> 
  2537.       Delete from beginning of subfield to cursor.  
  2538.  
  2539.       <CtrlT> 
  2540.       Delete word to right of cursor.  
  2541.       
  2542.  
  2543.  
  2544.       Appendix B                    RACE                         Page 49
  2545.  
  2546.  
  2547.  
  2548.  
  2549.       <Ins> 
  2550.       Toggle insert mode on and off.  Fat cursor indicates insert  mode;
  2551.       thin cursor indicates overtype mode.  
  2552.  
  2553.       <CtrlR>, <CtrlQ><L> 
  2554.       Restore original contents of the field and continue editing.  
  2555.  
  2556.       <F1> 
  2557.       Help.   If  a  help  routine  has been established for the current
  2558.       field, the specific help topic will be shown.  
  2559.  
  2560.  
  2561.                            FIELD MOVEMENT COMMANDS 
  2562.  
  2563.       These commands allow you to move the cursor  from  one  field  (or
  2564.       subfield) to another while editing a user record.  
  2565.  
  2566.       <Enter>, <CtrlM> 
  2567.       Accept contents of field and move to the next one.  
  2568.  
  2569.       <Tab>, <CtrlI> 
  2570.       Move cursor to the beginning of the next subfield.  
  2571.  
  2572.       <ShiftTab> 
  2573.       Move cursor to the beginning of the previous subfield.  
  2574.  
  2575.       <Up>, <CtrlE> 
  2576.       Move cursor to last field above the current one.  
  2577.  
  2578.       <Down>, <CtrlX> 
  2579.       Move cursor to last field below the current one.  
  2580.  
  2581.       <CtrlPgUp>, <CtrlQ><R> 
  2582.       Move cursor to first field on screen.  
  2583.  
  2584.       <CtrlPgDn>, <CtrlQ><C> 
  2585.       Move cursor to last field on screen.  
  2586.  
  2587.                                 EXIT COMMANDS 
  2588.  
  2589.       <CtrlEnter>, <CtrlK><D>, <CtrlK><Q> 
  2590.       Quit editing.  Accepts all changes to the current user record.  
  2591.  
  2592.       <Esc>, <CtrlBreak> 
  2593.       Abort.   Restores the original contents of the user's record.  Any
  2594.       changes not saved are lost.  
  2595.  
  2596.                                 #EOF#
  2597.       
  2598.